home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1996 #6 / Amiga Plus CD - 1996 - No. 06.iso / pd / programmierung / gadutil / docs / autodocs / 32.gu_createmenusa < prev    next >
Text File  |  1996-05-31  |  2KB  |  46 lines
  1. gadutil.library/GU_CreateMenusA               gadutil.library/GU_CreateMenusA
  2.  
  3.    NAME
  4.     GU_CreateMenusA -- Allocate and fill out a menu structure.
  5.  
  6.    SYNOPSIS
  7.     menu = GU_CreateMenusA(newmenu, taglist)
  8.     D0                     A0       A1
  9.  
  10.     struct Menu *GU_CreateMenusA(struct NewMenu *, struct TagItem *);
  11.  
  12.    FUNCTION
  13.     CreateMenusA() allocates and initializes a complete menu
  14.     structure based on the supplied array of NewMenu structures.
  15.     Optionally, CreateMenusA() can allocate and initialize a complete
  16.     set of menu items and sub-items for a single menu title.  This
  17.     is dictated by the contents of the array of NewMenus.
  18.  
  19.     These GadTools routines are only here to make it simpler for someone
  20.     who wants to use them. This for example, is of no use if you use the
  21.     GadUtil function GU_CreateLocMenuA() to define localized (optional)
  22.     menus with automatic hotkey handlimg etc.
  23.  
  24.    INPUTS
  25.     newmenu - pointer to an array of initialized struct NewMenus.
  26.     tagList - pointer to an array of tags providing optional extra
  27.           parameters, or NULL.
  28.  
  29.    TAGS
  30.     See gadtools/CreateMenusA() for available tags.
  31.  
  32.    RESULT
  33.     menu - pointer to the resulting initialized menu structure (or
  34.               the resulting FirstItem), with all the links for menu items
  35.               and subitems in place.
  36.               The result will be NULL if CreateMenusA() could not allocate
  37.               memory for the menus, or if the NewMenu array had an
  38.               illegal arrangement (eg. NM_SUB following NM_TITLE).
  39.               (see also the GTMN_SecondaryError tag above).
  40.  
  41.    NOTES
  42.     See gadtools/CreateMenusA() for more information.
  43.  
  44.    SEE ALSO
  45.     GU_LayoutMenusA(), GU_FreeMenus(), gadtools/CreateMenusA()
  46.